home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmconvscale.z / pmconvscale
Text File  |  1997-04-03  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMCCCCOOOONNNNVVVVSSSSCCCCAAAALLLLEEEE((((3333))))                                                  PPPPMMMMCCCCOOOONNNNVVVVSSSSCCCCAAAALLLLEEEE((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmCCCCoooonnnnvvvvSSSSccccaaaalllleeee - rescale a performance metric value
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmCCCCoooonnnnvvvvSSSSccccaaaalllleeee((((iiiinnnntttt ttttyyyyppppeeee,,,, ppppmmmmAAAAttttoooommmmVVVVaaaalllluuuueeee ****iiiivvvvaaaallll,,,, ppppmmmmUUUUnnnniiiittttssss ****iiiiuuuunnnniiiitttt,,,, ppppmmmmAAAAttttoooommmmVVVVaaaalllluuuueeee
  15.      ****oooovvvvaaaallll,,,, ppppmmmmUUUUnnnniiiittttssss ****oooouuuunnnniiiitttt))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      All performance metric values may be encoded in a _p_m_A_t_o_m_V_a_l_u_e union,
  21.      defined as follows;
  22.  
  23.           typedef union {
  24.               __int32_t    l;     /* 32-bit signed */
  25.               __uint32_t   ul;    /* 32-bit unsigned */
  26.               __int64_t    ll;    /* 64-bit signed */
  27.               __uint64_t   ull;   /* 64-bit unsigned */
  28.               float        f;     /* 32-bit floating point */
  29.               double       d;     /* 64-bit floating point */
  30.               char         *cp;   /* char ptr */
  31.               void         *vp;   /* void ptr */
  32.           } pmAtomValue;
  33.  
  34.      The encoding of a performance metric's dimensionality and scale uses a
  35.      _p_m_U_n_i_t_s structure; see ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3).
  36.  
  37.      Given a performance metric value pointed to by _i_v_a_l multiply it by a
  38.      scale factor and return the value in _o_v_a_l.  The scaling takes place from
  39.      the units defined by _i_u_n_i_t into the units defined by _o_u_n_i_t.  Both input
  40.      and output units must have the same dimensionality.
  41.  
  42.      The performance metric type for both input and output values is
  43.      determined by _t_y_p_e, the value for which is typically extracted from a
  44.      _p_m_D_e_s_c structure, following a call to ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3) for a particular
  45.      performance metric.
  46.  
  47.      ppppmmmmCCCCoooonnnnvvvvSSSSccccaaaalllleeee is most useful when values returned via ppppmmmmFFFFeeeettttcccchhhh(3), (and
  48.      possibly extracted using ppppmmmmEEEExxxxttttrrrraaaaccccttttVVVVaaaalllluuuueeee(3)) need to be normalized into
  49.      some canonical scale and units for the purposes of computation.
  50.  
  51. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.      PPPPMMMMAAAAPPPPIIII(3), ppppmmmmAAAAttttoooommmmSSSSttttrrrr(3), ppppmmmmEEEExxxxttttrrrraaaaccccttttVVVVaaaalllluuuueeee(3), ppppmmmmFFFFeeeettttcccchhhh(3) ppppmmmmLLLLooooooookkkkuuuuppppDDDDeeeesssscccc(3),
  53.      ppppmmmmPPPPrrrriiiinnnnttttVVVVaaaalllluuuueeee(3), ppppmmmmTTTTyyyyppppeeeeSSSSttttrrrr(3) and ppppmmmmUUUUnnnniiiittttssssSSSSttttrrrr(3).
  54.  
  55. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  56.      PPPPMMMM____EEEERRRRRRRR____CCCCOOOONNNNVVVV
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMCCCCOOOONNNNVVVVSSSSCCCCAAAALLLLEEEE((((3333))))                                                  PPPPMMMMCCCCOOOONNNNVVVVSSSSCCCCAAAALLLLEEEE((((3333))))
  71.  
  72.  
  73.  
  74.           _i_u_n_i_t and _o_u_n_i_t have different dimensionality, or have inappropriate
  75.           _t_y_p_e
  76.  
  77.      PPPPMMMM____EEEERRRRRRRR____UUUUNNNNIIIITTTT
  78.  
  79.           Inappropriate _i_u_n_i_t or _o_u_n_i_t parameter
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.